package com.smart.community.feign.region.fallback;

import java.util.Collections;
import java.util.List;

import org.springframework.stereotype.Component;

import com.smart.community.feign.common.BaseFeignFallbackFactory;
import com.smart.community.feign.region.dto.RegionDTO;
import com.smart.community.feign.region.dto.RegionTreeDTO;
import com.smart.community.feign.region.service.RegionFeignService;

import lombok.extern.slf4j.Slf4j;

/**
 * 区域服务Feign接口降级处理工厂
 * 
 * 当区域服务不可用时，提供降级处理：
 * 1. 返回安全的默认值，避免调用方异常
 * 2. 记录详细的错误日志，便于问题排查
 * 3. 确保系统稳定性，避免级联故障
 * 
 * @author Wu.Liang
 * @version 2.0.0
 * @since 2025-01-21
 * @updated 2025-08-28 - 继承BaseFeignFallbackFactory，使用统一的降级处理标准
 */
@Slf4j
@Component
public class RegionFeignFallbackFactory extends BaseFeignFallbackFactory<RegionFeignService> {
    
    @Override
    public RegionFeignService create(Throwable cause) {
        // 使用基类的统一日志记录方法，区分异常类型
        if (isServiceUnavailable(cause)) {
            logServiceUnavailable(getServiceName(), cause);
        } else {
            log.warn("{}服务调用异常，执行降级处理: {}", getServiceName(), cause.getMessage());
        }
        
        return new RegionFeignService() {
            
            @Override
            public List<RegionTreeDTO> getRegionTree(Long parentId) {
                logMethodFallback("getRegionTree", parentId);
                return Collections.emptyList(); // 返回空列表，不影响业务
            }
            
            @Override
            public List<RegionTreeDTO> getCompleteRegionTree(Long parentId) {
                logMethodFallback("getCompleteRegionTree", parentId);
                return Collections.emptyList(); // 返回空列表，不影响业务
            }
            
            @Override
            public RegionDTO getRegionById(Long regionId) {
                logMethodFallback("getRegionById", regionId);
                return null; // 返回null，表示未找到
            }
            
            @Override
            public RegionDTO getRegionByCode(String regionCode) {
                logMethodFallback("getRegionByCode", regionCode);
                return null; // 返回null，表示未找到
            }
            
            @Override
            public List<RegionDTO> getRegionsByType(Integer regionType) {
                logMethodFallback("getRegionsByType", regionType);
                return Collections.emptyList(); // 返回空列表，不影响业务
            }
            
            @Override
            public List<RegionDTO> getChildRegions(Long regionId) {
                logMethodFallback("getChildRegions", regionId);
                return Collections.emptyList(); // 返回空列表，不影响业务
            }
            
            @Override
            public List<RegionDTO> getRegionPath(Long regionId) {
                logMethodFallback("getRegionPath", regionId);
                return Collections.emptyList(); // 返回空列表，不影响业务
            }
            
            @Override
            public List<RegionDTO> getRegionsByIds(List<Long> regionIds) {
                logMethodFallback("getRegionsByIds", regionIds);
                return Collections.emptyList(); // 返回空列表，不影响业务
            }
            
            @Override
            public Boolean checkRegionCodeExists(String regionCode, Long excludeRegionId) {
                logMethodFallback("checkRegionCodeExists", regionCode, excludeRegionId);
                return false; // 返回false，表示不存在，允许创建
            }
            
            @Override
            public List<RegionDTO> searchRegionsByName(String regionName) {
                logMethodFallback("searchRegionsByName", regionName);
                return Collections.emptyList(); // 返回空列表，不影响业务
            }
            
            @Override
            public Object getRegionStats(Long regionId) {
                logMethodFallback("getRegionStats", regionId);
                return null; // 返回null，表示无统计数据
            }
            
            @Override
            public Object getAllRegionStatistics() {
                logMethodFallback("getAllRegionStatistics");
                return null; // 返回null，表示无统计数据
            }
            
            @Override
            public Boolean clearRegionCache(Long regionId) {
                logMethodFallback("clearRegionCache", regionId);
                return false; // 返回false，表示清除失败
            }
            
            @Override
            public Boolean clearAllRegionCache() {
                logMethodFallback("clearAllRegionCache");
                return false; // 返回false，表示清除失败
            }
            
            @Override
            public Boolean refreshRegionStats(Long regionId) {
                logMethodFallback("refreshRegionStats", regionId);
                return false; // 返回false，表示刷新失败
            }

            @Override
            public List<Long> getRegionAndDescendantIds(Long regionId) {
                logMethodFallback("getRegionAndDescendantIds", regionId);
                return Collections.emptyList(); // 返回空列表，不影响业务
            }
        };
    }
    
    @Override
    protected String getServiceName() {
        return "区域服务";
    }
} 